AgilePress Content Block for ACFbyAgilePress

AgilePress Content Block for ACF is a versatile tool developed by AgilePress that allows you to create dynamic HTML content with Advanced Custom Fields integration. It supports four powerful syntaxes for different ACF field types:

• Simple fields: Use {field_name} for text, number, and other simple fields
• Group fields: Use {group_name:sub_field_name} to access fields within ACF groups
• Repeaters & Galleries: Use {{repeater_name}} HTML content with {sub_field} tags {{/repeater_name}} to loop through repeater fields and image galleries
• Conditionals: Use {{#if field}}...{{/if}} for conditional content display with support for = and != comparisons

This block is perfect for:

• Displaying custom field data in formatted HTML
• Creating dynamic templates with ACF fields
• Building complex layouts that pull data from custom fields
• Looping through repeater fields and image galleries
• Accessing nested group field data
• Showing/hiding content based on field values
• Integrating ACF data seamlessly into your content

The block provides an intuitive sidebar editor where you can write HTML and insert ACF field tags. On the frontend, these tags are automatically replaced with the actual values from your Advanced Custom Fields.

Requirements:

• Advanced Custom Fields (free or PRO version)
• WordPress 6.1 or higher
• PHP 7.0 or higher

Usage Examples

Example 1 – Simple field display:

  
Latitude: {latitude}
  
Longitude: {longitude}

Example 2 – Group field access:

  
{contact_info:name}
  
Email: {contact_info:email}
  
Phone: {contact_info:phone}

Example 3 – Repeater field loop:

  {{team_member}}
    

      
{name}
      
{position}
      
{bio}
    
  {{/team_member}}

Example 4 – Gallery field loop:

  {{project_images}}
    

      
      
    
  {{/project_images}}

Example 5 – Conditional display:

  {{#if featured}}
    Featured
  {{/if}}

  
{title}

  {{#if status = published}}
    
Published: {date}
  {{#elseif status = draft}}
    
This is a draft
  {{#else}}
    
Pending review
  {{/if}}

  {{#if author_name != Anonymous}}
    
By {author_name}
  {{/if}}

Example 6 – Complex combination:

  

    {{#if is_featured}}
      Featured Project
    {{/if}}

    
{project_title}
    

      Location: {location:city}, {location:country}

      Date: {project_date}
    
  

  

    {{project_gallery}}
      

        
        
      
    {{/project_gallery}}
  

  {{#if features}}
    

      
Project Features
      

        {{features}}
          

            {feature_name}: {feature_value}
          
        {{/features}}
      
    
  {{/if}}

  
Additional Information

Security:
All field values are properly escaped using WordPress security functions (esc_html(), esc_url(), wp_kses_post()) to prevent XSS attacks and ensure safe output.

Performance:
The block uses WordPress native functions and ACF’s optimized field retrieval methods. Field values are processed server-side during render, ensuring optimal frontend performance.

Compatibility:

• WordPress 6.1+ (tested up to 6.9)
• PHP 7.0+ (tested up to 8.3)
• ACF free version 5.0+
• ACF PRO 5.0+
• Classic and Block themes

Developer Notes:
The block follows WordPress coding standards and uses